home *** CD-ROM | disk | FTP | other *** search
/ Computer Inter@ctive 17 / Computer Interactive cdrom 17 - gen 99.iso / ZDNETIT / CONTENT / ACESOFT.ZIP / ASWIT.DOC < prev    next >
Encoding:
Text File  |  1998-11-01  |  11.9 KB  |  287 lines
  1. *****************************************************************************
  2. FILENAME:       <ASWIT.COM>
  3. *****************************************************************************
  4. Date:           October 28th 1998.
  5. Description:    ACESOFT SUBLIMATE WRITING INTO TEXT.
  6. Version:        1.20 FOURTH MAJOR VERSION.
  7. Purpose:        A command line text file ASC2 normaliser,
  8.         an automatic HTML address extractor and
  9.         an automatic DB/HST/WBS address extractor.
  10.  
  11. *****************************************************************************
  12. LEGAL NOTICE ON USAGE.
  13. *****************************************************************************
  14.     This Document Copyright (c) 1998 of Mr. Denver Johnson BSc.
  15.  
  16.     ASWIT.COM copyright (c) 1998  of Mr. Denver Johnson BSc.
  17.  
  18.     All rights reserved.
  19.  
  20.     Non-registered users are granted a limited license to use the above 
  21. mentioned software and documentation on a trial basis for up to 90 days. 
  22.     
  23.     Use except for this limited period requires registration.
  24.  
  25.     Extended use of non-registered copies by any individual or agency is 
  26. strictly prohibited.
  27.  
  28.     No user shall have licence to modify any of the software package in 
  29. any way other than to change the prescribed default settings.
  30.  
  31.     Use of registered copies of ASWIT.COM by any other person than the
  32. licensee is explicitly forbidden.
  33.  
  34. *****************************************************************************
  35. DETAILED DESCRIPTION:
  36. ****************************************************************************
  37.       
  38.  
  39.       *ASWIT is primarily a low memory use, DOS command line utility for
  40. automatically stripping INTERNET addresses from HTML files as well as HISTORY
  41. files such as that created by NETSCAPE NAVIGATOR (NETSCAPE.HST) and WBS files
  42. created by MICROVISION WEBEXPRESS.  
  43.  
  44.     There are two types of file in this category:  
  45.  
  46. HTML files (*.HTM) in which speech marks are searched for containing: '/', 
  47. 'http', '.htm', '.gif', '.jpg', '.pl', '.ra', '.mov', '.exe', '.com', '.cgi', 
  48. '.arj', 'jpe', 'jfi' and '.zip' strings to make the output file; 
  49.  
  50. and DB/HST/WBS (*.DB, *.WBS or *.HST) files which begin '?:' 
  51. or contain 'HTTP' and end with a NUL character or non seven bit ASC2 character 
  52. (greater than or equal to 80h).  
  53.  
  54. For each type the case is ignored so that 'HTTP' also means 'http'.
  55.       
  56.       
  57.       
  58.       ASWIT also has the secondary function of being able to convert any DOS
  59. file given to it (with a file type other than HTM, WBS, DB, or HST) into a 100%
  60. DOS usable ASC2 text file.  This means that NUL characters (zero bytes) and 
  61. NUL strings (multiple zero bytes) are removed from the source file and 
  62. converted into full carriage returns, while end of text markers are converted
  63. to spaces.  This function of ASWIT is quite sophisticated and uses a two 
  64. pass system to process general files:
  65.  
  66.         the first scan is to identify what type of carriage return 
  67. (if any) the input file uses; 
  68.  
  69.         the second scan is there to do the actual changes if 
  70. necessary.  ASWIT also turns all of the carriage returns into the standard 
  71. DOS format.
  72.       
  73.       *N.B. in each case above the original file is left unaltered.  So
  74. that if you don't like the results the master is left unaffected:
  75.  
  76.  
  77.  
  78.       The new edited file keeps the same name as your original but takes on 
  79. the new extension of *.ASW.  Since it is assumed that all files of this type 
  80. were created by ASWIT, ASW type files cannot be handled.
  81.  
  82.       As can be ascertained from the above, the same file can be treated in
  83. several different ways merely by changing it's name, so that the way in which
  84. a file is treated is at the user's discretion.  It should be noted however that
  85. if this is to be done it may be necessary to change the file name as well as
  86. type, since the output file is always in the form of INPUT FILE.ASW.
  87.       
  88.       ShareWare the Program is for Demonstration Purposes Only and 
  89. Should be Registered.  To emphasise this point the ShareWare version has a 
  90. 6k input file restriction feature.  The Registered Program is Licensed for 
  91. Use on One Machine only.
  92.       
  93.       Last but not least ASWIT was written in 100% assembly language and is
  94. meant to be memory efficient, very portable and fast.  
  95.  
  96.  
  97. *****************************************************************************
  98. SUGGESTED APPLICATIONS:
  99. *****************************************************************************
  100. **DO NOT**
  101.       Stripping INTERNET files of addresses systematically could be thought
  102. of as a HACKING function.  However the author can in no way condone this and 
  103. ASWIT can only be licensed for legitimate purposes only.
  104.  
  105.       ASWIT was meant to be flexible in it's action and for this reason the 
  106. author can in no way guarantee the accuracy of it's translations.
  107.  
  108.       Do not PIRATE or in any way modify this program.  If it is an official
  109. registered version it should also contain your serial number, address and name.
  110. If you possess a ShareWare version please consider registering it for a fully
  111. functioning personalised copy.
  112.  
  113. ****DO****
  114.       Pass on the Shareware version of ASWIT for distribution.
  115.       Make sure to register your self a customised full edition of ASWIT.
  116.  
  117. *****************************************************************************
  118. ERROR RETURN:
  119. *****************************************************************************
  120.       ASWIT gives both error messages of it's own (see ASWIT.TXT) as well as 
  121. full DOS INT 59h extended error information.
  122.  
  123. *****************************************************************************
  124. INSTRUCTIONS:
  125. *****************************************************************************
  126.       ASWIT's memory requirements are very modest (only the space it 
  127. occupies on your disk) and so it should run in any PC (>=8086) environment
  128. (>=DOS 3) including all versions of WINDOWS.  However remember that it is a 
  129. DOS line entry command and as such if used from WINDOWS, users should shell
  130. out to the DOS prompt temporarily.
  131.  
  132.       Otherwise the basic use of ASWIT is simplicity it's self:
  133.  
  134. >[PATH]FULL_FILE NAME (including file type)<ENTER>
  135.  
  136.       The resultant output file will be:
  137. >[PATH]FILE_NAME.ASW
  138.  
  139.  
  140.       To see the registration details, version number and copyright name 
  141. simply type:
  142.          ASWIT<ENTER> 
  143.  
  144. when ASWIT.COM is on the PATH (the current directory or in one listed in the 
  145. DOS environment line) .
  146.  
  147. ********************************************************************************
  148. HINTS 'N TIPS:
  149. ********************************************************************************
  150.  
  151.     Since you have probably already tried a Shareware Version of ASWIT then 
  152. you probably know that use of ASWIT in DOS is simplicity it's self:
  153.  
  154.       Type: ASWIT Filename.Type  -------->  To Produce: Filename.ASW
  155.  
  156.                  or
  157.  
  158.       Type: ASWIT      -------->  To Produce: The Help Screen and User Details
  159.  
  160.  
  161.     However ASWIT can be used indirectly from within Windows using the PIF 
  162. File included with the ASWIT Package:
  163.  
  164.     Simply ASSOCIATE File Types of your choice (.DB,.HTM,.HST,.WBS) with 
  165. ASWIT.COM from within the 'FILE' Menu of your 'Program Manager'.
  166.  
  167.     ASWIT.COM can usually be accessed directly from Windows, without using
  168. the PIF file and there is now a dedicated Visual Basic front end for it.
  169.  
  170.  
  171. *Remember: ASWIT splits all files into three categories:
  172.  
  173.       1).   *.ASW      ASWIT Will not process.
  174.       2).   *.HTM      ASWIT Treats as Text Files for the stripping of 
  175.          addresses to create *.ASW.
  176.       3).   *.DB; *.HST; *.WBS  ASWIT treats as Binary Data for the 
  177.          stripping of addresses to create *.ASW.
  178.       4).   <ANY OTHER>  ASWIT treats intelligently as either Binary, ASC",
  179.          or Odd Format Text to create a regular Text File *.ASW.
  180.  
  181. ********************************************************************************
  182. USES:
  183. ********************************************************************************
  184.     Text is not always transferable between sources, but the fourth 
  185. function of ASWIT makes the extraction of at least something possible.
  186.  
  187.     Binary sources such as large EXE Files can for example be treated by 
  188. ASWIT for the capture of embedded Text.
  189.  
  190.     Net Files can be easily stripped of their links so that web sites can
  191. be visited as directories:      
  192.         e.g.  Http://xxxxxxxxx.yyy/.
  193.  
  194.  
  195.     Or saved directly to disk (see the Options Menu of your Web Browser) 
  196. for more ASWIT treatment, without ever having run in your browser.
  197.  
  198.     The procedure of using *.ASW Net Files is to view the file with a 
  199. Windows editor such as (WRITE.EXE), then copy any interesting address and 
  200. simply paste this into your browser.
  201.  
  202.     ASWIT does not just search for world wide web address but also for 
  203. local.  It also now looks for strings containing '/'; 'HTM'; 'JPG'; 'GIF' etc.
  204. in order to give the user a better picture of the web sites subdirectories.
  205.  
  206.  
  207.         i.e.  Http://xxxxxxxxxx.yyy/.
  208.  
  209. May not give a plain directory but:
  210.  
  211.         e.g.  Http://xxxxxxxxxx.yyy/pics/.
  212.  
  213. Found from an occurrence of "PICS/ZZZ.JPG" may well be unrestricted.
  214.  
  215. Or even in a restricted directory:
  216.  
  217.         e.g.  Http://xxxxxxxxxx.yyy/pics/zzz.jpg
  218.  
  219. Should be directly accessible.
  220.  
  221.  
  222.  
  223.     If you shut down your browser (Netscape) you can also use ASWIT to 
  224. monitor what addresses have been accessed by using ASWIT on 'NETSCAPE.HST' in 
  225. the 'TEMP' directory or 'FAT.DB' in the 'NETSCAPE\CACHE'.  this could be 
  226. useful for finding out where an active Hypertext File has accessed and it also
  227. has obvious security uses in finding out where other people have been.
  228.  
  229.  
  230. *****************************************************************************
  231. SETTING UP THE WINDOWS FRONT END.
  232. *****************************************************************************
  233.     ASWITT.EXE is a stand alone program.  Other than for ASWIT.PIF, 
  234. VBRUN300.DLL and of course ASWIT.COM V1.20 which should all be in a Windows 
  235. path or directory.
  236.  
  237.  
  238.     ASWITS.EXE and ASWITW.EXE both use the same INI file (ASWITS.INI),
  239. which is written to the Windows directory with the following defaults:
  240.  
  241. =============================================================================
  242. ACESOFT WINDOWS INTERFACE FOR ASWIT.COM V1.20
  243.  
  244. ASWIT_Win_Dir = 
  245. Editor_Name = WRITE.EXE
  246. Editor_Dir = 
  247. ASWIT_Pif_Dir = 
  248. AV3S_Pif_Dir = 
  249. AV3S_Pif_Cmd =  /F
  250. Refresh_Interval =  70
  251.  
  252. =============================================================================
  253.  
  254. ASWIT_Win_Dir is the path name of where your INI file is to be retrieved from.
  255.  
  256. Editor_Name is the full name of the text editor you use with Windows.
  257.  
  258. Editor_Dir is the path name of where your text editor is to be retrieved from.
  259.  
  260. ASWIT_Pif_Dir is the path name of where ASWIT.PIF is to be retrieved from.
  261.  
  262. AV3S_Pif_Dir is the path name of where AV3S.PIF is to be retrieved from.
  263.  
  264. AV3S_Pif_Cmd is the line command sent along to AV3S.COM: /B, /D, /E, /F, /G
  265. all give a tune, an optional number gives the tempo.    e.g. /D0
  266. For more information about AV3S.COM see the document AV3S_600.DOC.
  267.  
  268. Refresh_Interval is the screen and directory refresh timing constant.  Set 
  269. this value high on slow systems but be aware that there may be some delay in
  270. the response of the file select box to changes such as file deletions or 
  271. creations.  The default value of 60 is for a Cyrix 6x86 MXPR233 based system,
  272. faster systems could stand smaller values, it partly depends on what else is
  273. running within Windows at the same time.  Be warned however Visual Basic can
  274. easily be made to be a needless drain on CPU/system time.
  275.  
  276.  
  277.     Leave out any of the above either by accident or design and all of the
  278. values will be overwritten with the defaults.
  279.  
  280.  
  281.     ASWITS.EXE, ASWITT.EXE and ASWITW.EXE are all written in Microsoft
  282. Visual Basic 3.0 and as such VBRUN300.DLL must be present either in your
  283. system's PATHs or in the boot directory of the afore mentioned files.
  284.     
  285. *****************************************************************************
  286. *****************************************************************************
  287.